home *** CD-ROM | disk | FTP | other *** search
/ Popular Request / By Popular Request (Arsenal Computer)(SysOptics Distribution System).ISO / amiga1 / cardapp.lha / cardapp.doc < prev    next >
Text File  |  1994-03-22  |  6KB  |  159 lines
  1.  
  2.                                  CardApp V1.0
  3.  
  4. Description:
  5.  
  6. CardApp is an integrated application which provides similar functionality to
  7. the CLI programs CardList, CardAdd and CardAll.  It uses the AppIcon and
  8. AppMenuItem features of Workbench 2.0 (and above) to provide a simple,
  9. easy-to-use interface.
  10.  
  11.  
  12. Purpose:
  13.  
  14. CardApp, CardList, CardAdd and CardAll were written to enable PCMCIA cards
  15. from the Amstrad Notepad series (NC100, NC150 and NC200) to be read and
  16. written on a suitably equipped Amiga (i.e., one with a PCMCIA card slot,
  17. currently just the A600 and A1200).
  18.  
  19. * Caution: Don't boot up your Amiga with a write-enabled PCMCIA card from a
  20. * Notepad in the slot.  It will be cleared and configured as system RAM,
  21. * destroying all information on it.  Also, like floppy disks, don't remove a
  22. * PCMCIA card whilst it is being written to.
  23.  
  24.  
  25. Usage:
  26.  
  27. CardList - Template: V=VERBOSE/S.
  28. ========
  29. Lists the files stored on the Notepad PCMCIA card.  The default is a brief
  30. listing (name and size), but by using the "VERBOSE" switch you can get a
  31. more detailed listing (name, size and date).
  32.  
  33.   > cardlist
  34.   ... Brief listing
  35.  
  36.   > cardlist verbose
  37.   ... Detailed listing
  38.  
  39. You can run CardList from the Workbench by double-clicking on the icon.  The
  40. tooltype "VERBOSE" controls whether you get a verbose listing or not.
  41.  
  42.  
  43. CardAdd - Template: FORCE/S,FILE/M.
  44. =======
  45. You can specify any number of files to add to the Notepad PCMCIA card.
  46. Patterns can be used in conjunction with the standard "Spat" script supplied
  47. with Workbench.  If no card is present, it is not from a Notepad or it is
  48. not writable then the program will terminate.  The "FORCE" switch allows you
  49. to override the "Card in use" check, which is a simple device to try to stop
  50. several people writing to the card at the same time.
  51.  
  52.   > cardadd fred
  53.   ... File "fred" is added to card
  54.  
  55.   > cardadd fred sys:wilma df0:t/betty
  56.   ... Files "fred", "sys:wilma" (as "wilma") and "df0:t/betty" (as "betty")
  57.   are added to card
  58.  
  59.   > spat cardadd dh0:articles/#?
  60.   ... All files in "dh0:articles" are added to card
  61.  
  62. You can run CardAdd from the Workbench by selecting its icon,
  63. shift-selecting the files to add and double shift-clicking on the last file.
  64. Note: the Notepad filesystem is flat so you can't add directories.
  65.  
  66.  
  67. CardAll
  68. =======
  69. Extracts all files from the Notepad card to the current directory.
  70.  
  71.   > cardall
  72.   ... All files extracted from card
  73.  
  74.   > cd dh0:articles
  75.   > card all
  76.   ... All files extracted to "dh0:articles"
  77.  
  78. You can run CardAll from the Workbench by double-clicking on the icon.
  79.  
  80.  
  81. CardApp
  82. =======
  83. Just double click on the icon (or run it from the CLI).  To quit it, select
  84. "Quit CardApp" from the Tools Workbench menu (the one with "Reset WB" in
  85. it).
  86.  
  87. Files dropped onto the AppIcon which appears on the Workbench screen/window
  88. will be added to the Notepad PCMCIA card.  A small output window will show
  89. the status of the addition etc.  If no card is present, it is not from a
  90. Notepad or it is not writable then the program will terminate.  There is no
  91. "FORCE" option -- use CardAdd to override/correct the "Card in use" check.
  92.  
  93. Double-clicking on the AppIcon will give a listing of the files on the card.
  94. The tooltype "VERBOSE" on the CardApp icon controls whether this listing is
  95. detailed or not.  The listing will appear in the same output window as the
  96. messages from adding/extracting files.
  97.  
  98. Selecting "Extract" from the Tools Workbench menu will extract all files
  99. from the card to the RAM disk.  If you select a single directory or disk
  100. icon and then select "Extract" then the files will be extracted to this
  101. location instead.
  102.  
  103. Note: the same output window is used for all reports/listings.  You can zoom
  104. and even close this window whenever you like.  If you close it then it will
  105. reappear (cleared) if necessary.
  106.  
  107.  
  108. Blatant plug:
  109.  
  110. Written in Amiga E v2.1b, the fastest and best Amiga language there is.  And
  111. it's PD!  Much respect goes out to Wouter for such a wonderful compiler.
  112.  
  113.  
  114. History:
  115.  
  116. The Notepad is a cheap, portable computer which is ideal for typing essays,
  117. programs, etc. on the move or on a nice, comfy sofa in front of the TV
  118. (which is how I use it!).  It fills the gap whilst there is no portable
  119. Amiga on the market, and it runs a slightly cut-down version of Protext.
  120. The only problem is that, until now, the only way of getting stuff from the
  121. Notepad to the Amiga (and vice versa) was to use a slow serial link or buy
  122. the expensive Lapcat software and have a slow parallel link.  However, to
  123. make real use of the Notepad you need a PCMCIA card, and then transferring
  124. several large files is an enormouse pain.  Wouldn't it be good if the Amiga
  125. could read the card?
  126.  
  127. So, I set about trying to use the PCMCIA card slot on my A1200, armed with
  128. absolutely no documentation.  Someone on the Internet answered my question
  129. to comp.sys.amiga.programmer and told me that the card would probably be
  130. mapped into a certain part of the Amiga's address space.  This, luckily, is
  131. the case, even if the card is not in a format recognised by the Amiga.
  132.  
  133. The next step was to decode the filesystem and try to do a file listing.
  134. The date stuff was a late addition since the date encoding was particularly
  135. strange (e.g., the top 7 bits of one byte is the number of years, and the
  136. remaining bit is the top bit of the number of months...).  After solving
  137. this I set about designing the CLI programs, and then I put them together to
  138. make CardApp.  What I would have liked to have done was make a device (and
  139. filesystem?) like the other Amiga storage devices, but I don't know how to.
  140. (There is no decent documentation on this that I can get hold of...)
  141.  
  142. This first version is untested on anything other than my A1200 with a 512KB
  143. PCMCIA card for an NC100 Notepad.  Possible problems could arise with
  144. A1200's which have Fast RAM (illegally) mapped into the PCMCIA address
  145. space, or with cards of different sizes or from different model Notepads.
  146. This latter problem is hopefully solved by the flexible manner in which I
  147. attack the filesystem on the card.  The only drawback is that I don't feel I
  148. can sensibly supply a format option (you need to format the card on the
  149. Notepad).
  150.  
  151. You can contact me by Email (for feedback, bug reports, etc.) at the
  152. following address: m88jrh@uk.ac.ox.ecs
  153.  
  154.  
  155. Legal stuff:
  156.  
  157. The programs CardList, CardAdd, CardAll and CardApp are Copyright (c) 1994
  158. Jason R. Hulance.  Apart from this the GNU General Public License holds.
  159.